home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / prgtools / mint / mntdoc01.zoo / mintdoc / cat2 / talarm.nr < prev   
Encoding:
Text File  |  1993-03-03  |  1.4 KB  |  67 lines
  1.  
  2.  
  3.  
  4. Talarm(2)                  Oct. 1, 1991                 Talarm(2)
  5.  
  6.  
  7. N✓NA✓AM✓ME✓E
  8.        Talarm - schedule an alarm to occur
  9.  
  10. S✓SY✓YN✓NO✓OP✓PS✓SI✓IS✓S
  11.        LONG Talarm( LONG time );
  12.  
  13. D✓DE✓ES✓SC✓CR✓RI✓IP✓PT✓TI✓IO✓ON✓N
  14.        If _✓t_✓i_✓m_✓e is greater than 0, schedule a SIGALRM signal to be
  15.        delivered to the process that many seconds from now.  Note
  16.        that  unless a handler for SIGALRM has been established by
  17.        means of the _✓P_✓s_✓i_✓g_✓n_✓a_✓l function, then the signal  will  kill
  18.        the process.
  19.  
  20.        If  _✓t_✓i_✓m_✓e == 0, then any previously scheduled alarm is can-
  21.        celled.
  22.  
  23.        If _✓t_✓i_✓m_✓e is negative, then no change is made to what alarms
  24.        are  scheduled; in this case, only the returned value (the
  25.        number of seconds left before any alarm) is of interest.
  26.  
  27. R✓RE✓ET✓TU✓UR✓RN✓NS✓S
  28.        If an alarm had been scheduled before this call to _✓T_✓a_✓l_✓a_✓r_✓m,
  29.        return  the  number of seconds remaining until that previ-
  30.        ously scheduled alarm.
  31.  
  32.        Otherwise, return 0.
  33.  
  34. S✓SE✓EE✓E A✓AL✓LS✓SO✓O
  35.        _✓P_✓a_✓u_✓s_✓e(2), _✓P_✓s_✓i_✓g_✓n_✓a_✓l(2)
  36.  
  37. B✓BU✓UG✓GS✓S
  38.        Internal calculations are done in milliseconds,  not  sec-
  39.        onds, so the returned value is not exactly accurate.
  40.  
  41.        For  the same reason, setting an alarm more than 2 million
  42.        seconds or so into the future will not work correctly.
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64. Version 0.9          MiNT Programmer's Manual                   1
  65.  
  66.  
  67.